Old Dimension Values in Endeca XM Editor ( legacy Workbench state files) - Endeca Workbench

Problem Statement:

Endeca Workbench user finds stale dimension values in the Editor and gets confused on which Dimension values to be selected.




Solution:

To manually clear the legacy Workbench state files:
1. Stop the Endeca Tools Service.
2. Take a back up of  /opt/app/endeca/ToolsAndFrameworks/11.1.x/server/workspace/state/emanager/instances/app_name/resources
3. Remove the full contents of the/opt/app/endeca/ToolsAndFrameworks/11.1.x/server/workspace/state/emanager/instances/app_name/resources  directory.
4. Start the Endeca Tools Service.
5. Run the following two commands to push your current (good) config back to Workbench:
- /control/update_web_studio_config.sh
(this pushes the XML files from /opt/app/endeca/app_name/data/cas_output up to Workbench. Workbench may still use some of the dimension settings from here.)
- the post-CAS dimension file, which pushes the dimension values generated by CAS to Workbench (here is working example from Discover, where you can switch out the app name references for your own):

/opt/app/endeca/PlatformServices/11.x/bin
emgr_update --host localhost:8006 --action set_post_forge_dims --post_forge_file C:\apps\Discover\data\workbench\temp\Discover.dimensions.xml --prefix Discover --app_name Discover
If you clear the browser cache, the next time you go back to the location dialogue, the stale dimension values should be gone and it should be functioning with current data. 

How to change admin password in Endeca (Workbench, CAS crawl, Endeca Configuration Repository etc...)? - Endeca Workbench version 11.1

If the admin password is still known, but you want to change it to new value - these are the instructions from the guide(s):

1. Login to Workbench as the admin (by default, the username would be admin, the password would also be admin). Change it to the new password.

- This will also change the password for the Endeca Configuration Repository.

2)  Run below command
Location: /opt/app/endeca/ToolsAndFrameworks/11.1.0/credential_store/bin> ./managed_credentials.sh add --user admin --key ifcr
key in the NewPassword and Repeat. 

3)  Stop the Endeca Tools Service
   Update the credentials in webstudio file
   /opt/app/endeca/ToolsAndFrameworks/11.1.0/server/workspace/conf/webstudio.properties 
   Look for the ifcr.password property 
   Start the Endeca Tools Service 

4) Update password in CAS crawl

/opt/app/endeca/apps/CRS/config/cas/last-mile-crawl.xml

5) Delete existing crawl file and re-create a new crawl file
Location: /opt/app/endeca/CAS/11.1.0/bin
./cas-cmd.sh deleteCrawl -id CRS-last-mile-crawl
./cas-cmd.sh createCrawls -f /opt/app/endeca/apps/CRS/config/cas/last-mile-crawl.xml

6) In the ATG Index Server go to below component and update new password:
/dyn/admin/atg/endeca/index/ConfigImportDocumentSubmitter

workbenchUser	admin
workbenchPassword	admin123

7) Run Baseline_update from ATG dyn/admin

/atg/commerce/endeca/index/ProductCatalogSimpleIndexingAdmin/

How to create Endeca Discover Electronics Reference Application using Deployment Template? - Deployment Template

To deploy the Discover Electronics reference application:

1. Ensure that the Endeca Tools Service is running.

2. If you haven't already, create a directory for deployed Endeca applications, such as C:\Endeca\apps on Windows, or /usr/local/endeca/apps on UNIX.

3. Run the Deployment Template to deploy the application:

    a) Open a command prompt or command shell.

    b) Navigate to the \ToolsAndFrameworks\\deployment_template\bin
       directory on Windows, or /ToolsAndFrameworks/deployment_template/bin on UNIX.

    c) Run the deploy script with the --app flag and an argument that specifies the path to the deploy.xml descriptor file for Discover Electronics:For example:
      C:\Endeca\ToolsAndFrameworks\3.1.0\deployment_template\bin>deploy --app C:\Endeca\ToolsAndFrameworks\3.1.0\reference\discover-data\deploy.xml

    d) Confirm the Platform Services installation directory.

    e) Select y to install a base application.

    f) Specify Discover as the application name.
      Note:The application configuration depends on this name and case sensitivity is important.

    g) Specify the application directory previously created for Endeca applications.This is typically a directory, such as C:\Endeca\apps on Windows or /usr/local/endeca/apps on UNIX.

    h) Oracle recommends using the default options for subsequent prompts.

4. Navigate to the control directory of your new deployed application.
  This is located under your application directory,
  for example:C:\Endeca\apps\Discover\control on Windows.

5. Initialize the application and load the baseline data and templates:
    a) Run the initialize_services script.
      This script does the following:
        • Provisions the application in the Endeca Application Controller.
        • Uploads sample templates and configuration to the application.
        • Uploads sample content and media to the application. (This action occurs only if you are using Experience Manager.)

 b) Run the load_baseline_test_data script.

c) Run the baseline_update script.

d) Run the promote_content script.

6. Confirm that the Discover Electronics reference applications are running:
    • Navigate to http://localhost:8006/discover-authoring to view the authoring version of the Discover application.
    • Navigate to http://localhost:8006/discover to view the live version of the Discover application.

For more details refer below Oracle  documentation:

https://docs.oracle.com/cd/E35827_01/ToolsAndFrameworks.310/pdf/TFInstallGuide.pdf
Page #20 & 21

How to find Endeca component versions Ex: Dgraphs, Deployment template, Forge, CAS and Tools & Framework? - Endeca component versions

MDEX: 

Use below command
C:\Endeca\MDEX\6.5.1\bin>dgraph.exe --version
Endeca dgraph version 6.5.1.829811
Supports opti-XML version : 2.00
Supports binary IR version: 640
Interface specification :
  READS:dgidx=6.3.0a WRITES:dgraph=IR640
ICU version 51.2
OLT version OLT 1.4 140319
OpenSSL 1.0.0k 5 Feb 2013 

Deployment Template:

Use below command
C:\Endeca\apps\Discover\control>runcommand.bat --version
Deployment Template: 11.1.0

Platform Services: 

Use below command
C:\Endeca\PlatformServices\11.1.0\bin>forge.exe --version
INFO    01/19/16 03:14:25.991 UTC (1453173265991)       FORGE   {config}: forge 4.1-Internal-foo@bar-baz-beetle ("i86pc-MINGW32_NT-6.1")
INFO    01/19/16 03:14:25.996 UTC (1453173265995)       FORGE   {config}: Copyright 2001-2012 Oracle Endeca Technologies, Inc.
INFO    01/19/16 03:14:26.000 UTC (1453173265999)       FORGE   {config}: Command Line: forge.exe --version
forge 4.1-Internal-foo@bar-baz-beetle ("i86pc-MINGW32_NT-6.1")
Copyright 2001-2012 Oracle Endeca Technologies, Inc.
INFO    01/19/16 03:14:26.041 UTC (1453173266040)       FORGE   {config}: Initialized cURL, version: libcurl/7.16.4 OpenSSL/0.9.8 zlib/1.2.3
INFO    01/19/16 03:14:26.045 UTC (1453173266044)       FORGE   {config}: Forge completed successfully.

CAS:

Use below jar to find the version: 
C:\Endeca\CAS\11.1.0\lib\cas-cmd>cas-cmd-11.1.0.jar

Tools and Framework: 

Version is displayed on the login screen

ATG-Endeca Site Crashed due to Endeca content repository Corruption - v3.1.1

Problem Statement:
Site got crashed and not able to import backed-up Experience Manager rules.

Error when you Import rules:
Nov 5, 2015 3:25:32 PM com.endeca.soleng.eac.toolkit.utility.IFCRUtility importNode
INFO: Uploading contents to: http://localhost:8006/ifcr/sites/APP_NAME/configuration/tools/xmgr
Nov 5, 2015 3:25:33 PM com.endeca.soleng.eac.toolkit.utility.IFCRUtility importNode
INFO: Finished uploading contents.
Caused by: com.endeca.soleng.eac.toolkit.utility.IFCRUtility$HttpStatusException: Internal Server Error (500): javax.jcr.ItemNotFoundException: 731f7677-dc43-47d3-968e-3d1
6c49970c2/{}contentCollectionReferences
        at com.endeca.soleng.eac.toolkit.utility.IFCRUtility.execute(IFCRUtility.java:724)
        at com.endeca.soleng.eac.toolkit.utility.IFCRUtility.httpPost(IFCRUtility.java:671)
        at com.endeca.soleng.eac.toolkit.utility.IFCRUtility.httpPost(IFCRUtility.java:653)
        at com.endeca.soleng.eac.toolkit.utility.IFCRUtility.deleteNode(IFCRUtility.java:261)
        at com.endeca.soleng.eac.toolkit.component.IFCRComponent.importXml(IFCRComponent.java:195)
        at com.endeca.soleng.eac.toolkit.component.IFCRComponent.importXmlWithPrompt(IFCRComponent.java:144)
        ... 7 more


Solution:
1) Make sure you have a good copy of content repository export. To do this, execute export_site on an working environment.
 Ex: /opt/app/endeca/APP_NAME/control>./export_site.sh  XMRules.xml
2) Stop workbench.
3) Go to $ENDECA_TOOLS_CONF/state/
4) Rename sling and jackrabbit directory in here to anything other than sling and jackrabbit, or back them up to a different directory.
5) Restart workbench, this will cause the sling IFCR repository to be cleaned up.
   Note: If you have multiple apps, then all of them will be cleaned up. In this situation, run 6) and 7) below for each app.
6) Then run initialize_services./sh|bat --force from the app
         Ex: /opt/app/endeca/APP_NAME/control>./initialize_services./sh|bat --force 
7) Then import_site <export file>
       Ex: /opt/app/endeca/APP_NAME/control>./import_site.sh XMRules.xml
8) Execute a baseline_update from dyn/admin followed by a promote_content

Oracle Commerce 11.2 Released - Release Notes

Known Issues in this release:
 

1) (18816983) BCC user segment not appearing in Experience Manager

2)(18780298) Cartridge example causes error

3)(18895941) New user segment not appearing
4)(21363913) Renaming and moving pages are not updated in Experience Manager projects

5)(21502844) Renaming and saving a site page produces "Page not found" error
6)(21649751) Authoring assemblers are not being updated correctly after importing Workbench content

7)(21657293) Error message/out of sync message is displayed after renaming a rule

8)(21671840) Renaming a folder displays misleading error message

9)(21801912) Preview does not refresh after adding content

10)(21822985) Increase and decrease icons are missing

11)(21824187) Intermittently cannot add new rule using Internet Explorer

12)(21864376) Cannot export an application when a folder name is changed from upper to lower case

More info in below thread:
http://docs.oracle.com/cd/E67226_01/Common.112/pdf/RelNotes.pdf

Endeca Tools and Frameworks - Documentation

Tools and Frameworks 3.1.0
http://docs.oracle.com/cd/E35827_01/index.html

Tools and Frameworks 3.1.1
http://docs.oracle.com/cd/E38679_01/index.html

Tools and Frameworks 3.1.2
http://docs.oracle.com/cd/E40177_03/index.html

Tools and Frameworks 11.0
http://docs.oracle.com/cd/E51273_03/index.html

Tools and Frameworks 11.1
http://docs.oracle.com/cd/E55326_02/index.html